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SUBJECT: TS2000 SYSTEM SOFTWARE 


DISTRIBUTION: Grimm, Honnold, Hildreth, Corcoran, Skyrme 


A bug in the TS2000 System Software has surfaced which has (orien igiesidd pateg ace ae 
the following consequence: 


The process of calling the Function Dispatcher 
from the Dock Bank (i.e., machine code running 
in a cartridge) does not work. 


The following are possible workarounds: 


1. Don't call the service using the Function Dispatcher, but 
instead include the code for the service in the cartridge. 
This workaround makes sense for cartridge software which 
makes very few calls to the Function Dispatcher. 


2) Include a new version of the Function Dispatcher in the 
cartridge (see attached) and use it instead of the current 
Function Dispatcher. This workaround makes sense for 
cartridge software which makes many calls to the Function 
Dispatcher. 


Note: Designers are strongly advised not to circumvent the Function 
Dispatcher by calling services directly. Software implemented 
in this manner may become absolete as a result of future 
“system ROM releases. 


SMC:js \ 
attachment 


Here is what's needed to use the Function Dispatcher from the dock bank. 


There must be a copy of the DISPATCH routine in the ROS cartridge. 
There are two changes to the RAM based version of this routine. 


1 - The call to GET-WORD at address 624Ch is replaced with a call to 
XFER. Following is the code for XFER: 


PUSH IX 

LD C,OFFh ; B= scr bank, C = dest bank 
PUSH BC . 

PUSH HL s scr add. 

LD HL, ADDR ; ADDR is two bytes of machine 
PUSH HL 3; language variables 

LD BC,2 ; XFER two bytes 

PUSH BC 

LD BC,]1 ' 3 direction 

PUSH BC 

CALL 6722h 3 call RAM version of XFER-BYTES 
LD HL,(ADDR) 

POP IX 

RET 


2 - This change only has to be made if a RAM-based service is called 
via the Function Dispatcher. A new version of the RAM-based GET- 
STATUS routine must reside in the ROS. The call to GET-STATUS 
at address 6231h must change to call the ROS version. GET-STATUS 
Changes as follows: 


At label GS-HOME (addr 642dh), LD BC,0 is replaced with CALL GS-H. 
The GS-H routine is: cD 


DB FY IN A, (O8F4H) 3; Get status of dock & extension 
i wD ca 

ZA 15 6S LD A, (63f5h 

AT AND A 7 
ee RET Z 3; Return if no expansion banks 
A LD B.A 

16 €O GS-LOOP: LD D,80h 

5S LD E,B 

eb 5¢€63 CALL 635ch 3; Write-BS-Reg 

6 4O LD D,40h 

l= GO ED E, 80h 

Cp AD 63 CALL 63ADh 3 Read-BS-Reg 

7s LD A,E 
ce) ~ ORC 

HI LD C,A 
lo EF DJNZ GS-LOOP 

cy RET 


MORE BUGS AND FIXES 


Machine language AROS's must request 21 + n bytes for machine language 
variables, where n is the number it really wants. The machine language 
variable area then starts at 6855h. NOTE: This does not apply to 
AROS's that contain both BASIC and machine language. 


Any software that uses CALL_BANK with the param-out parameter greater 
than zero must first do the following: 


LD (6610h) ,9 


This patches the CALL--BANK in RAM to ensure that the proper amount 
of space is made on the stack for the return parameters. 


Any ROS software that use the calculator routines (RST 28h) or 
invoke any ROM routines that use it, must first initialize the 
MEM variable by doing the following: 


LD HL, 5C92h 
LD (5C68H), HL 


If a ROS wants chunk 3 enabled, it must do so itself. Otherwise, 
the bank switching code gets de-selected before the starting 
address is jumped to. 


Another reminder that machine language AROS's must explicitely 
set L mode by setting bit 3 of FLAGS.and writing a 0 to MODE. 


